Book Contents

Connections for the Program Launcher ActiveX control

The following table shows the connections to control the operation of the Program Launcher ActiveX control at run time. There are no additional parameters to configure the operation of the control beyond these connections.

Connections

Descriptions

ProgramLocation

Required

This connection contains the complete path and filename of the application program you wish to execute (for example, "ctlpnl.exe") using the control.

This property can be an explicit string or a string tag.

ProgramParameter

Optional

This connection contains optional command parameters to be used with the application configured in the ProgramLocation connection.

This property can be an explicit string or a string tag.

FocusEnable

Optional

While another application is running, the FactoryTalk View Machine Edition project may not be visible if it is in the background or minimized.

When the assigned tag transitions from a zero to non-zero value, the FactoryTalk View Machine Edition project is restored to the foreground.

LaunchEnable

Required

When the assigned tag transitions from a zero to non-zero value, the control launches the application configured in the ProgramLocation connection appending the optional command-line parameter(s) from the ProgramParameter connection.

The application is launched maximized and given focus. This connection must be a tag.

NewInstance

Optional

This connection configures how the control will act if the application configured in the ProgramLocation connection is executing when the FactoryTalk View Machine Edition application attempts to launch another instance.

If the configured tag is set to zero, the control will restore the application configured in the ProgramLocation connection to the foreground.

If the configured tag is set to one, the control will attempt to launch an additional instance of the application configured in the ProgramLocation connection.

MaximizeEnable

Optional

If the application specified in ProgramLocation becomes hidden behind the FactoryTalk View Machine Edition project or minimized, this property allows the application to be maximized.

To restore a minimized application, set the tag configured in MaximizeEnable to a non-zero value and the tag configured in NewInstance to zero before triggering the LaunchEnable tag.

CloseProgram

Optional

When the assigned tag transitions from a zero to non-zero value, the CloseProgram property will close the application configured in the ProgramLocation connection.

If multiple ActiveX controls are used to launch multiple application, only the control that launched a particular instance of an application can be used to close that application.

See also

Program Launcher ActiveX control

Program Launcher ActiveX control connections for FoxIt Reader

ProgramParameter connection examples